JSON 模块总览 - Overview

本分类做什么

JSON 解析、构建、类型读写 与 序列化；并包含 图像识别结果 JSON 的快速解析辅助（ParseMatchImage* 等）。与 图像识别、网络 HTTP 返回体配合使用。

---

一、文档级与释放

接口	差异
JsonParse	字符串 → 句柄（或内部对象 id）。
JsonCreateObject、JsonCreateArray	空 对象/数组 根。
JsonStringify	句柄 → 字符串。
JsonFree	必须 配对释放，防泄漏。

---

二、结构操作

接口	用途
JsonGetSize	对象键数或数组长度。
JsonGetValue、JsonSetValue	通用读写
JsonArrayAppend	数组 追加。
JsonClear	清空对象/数组。
JsonDeleteKey	删除键。

---

三、类型化读写

类型	读	写
字符串	JsonGetString	JsonSetString
数值	JsonGetNumber	JsonSetNumber
布尔	JsonGetBool	JsonSetBool
数组元素	JsonGetArrayItem	—（常配合 Append）

差异：GetValue 为 通用；Get*Number/String/Bool 做 类型断言。

---

四、图像识别专用

接口	用途
ParseMatchImageJson	单结果 JSON → 坐标等字段。
GetMatchImageAllCount	多结果 数量。
ParseMatchImageAllJson	多结果 逐条解析。

与通用 JsonParse 差异：针对 MatchImage 返回格式 做了 字段捷径，减少手写路径。

---

五、快速选型

需求	建议
HTTP 返回 JSON	JsonParse → JsonGetString 等
拼请求体	JsonCreateObject → JsonSet* → JsonStringify
找图结果	ParseMatchImageJson 系列

---

六、错误码

多数接口通过 err 输出参数 或 返回值 返回 JSONError 错误码（0 成功，非 0 失败）。读写失败时须检查错误码，勿单独依赖句柄或数值是否为 0。

错误码	含义
0	成功
1	无效句柄
2	解析失败
3	类型不匹配
4	键不存在
5	索引越界
6	未知错误

---

七、注意

• 大 JSON 注意 内存；循环内 JsonFree。
• 浮点精度 与 科学计数法 以插件实现为准。